---
title: Markdown Widget
description: Learn how to use the Markdown Widget in OpenLIT to add rich text, annotations, and links to your dashboards.
---

The **Markdown Widget** lets you add formatted text, notes, links, and headings directly to your dashboards. It’s perfect for adding context, documentation, or separating sections visually.

---

## 📌 Use Cases

- Add titles or descriptions to sections of your dashboard  
- Explain metrics or link to external documentation  
- Highlight goals, statuses, or next steps  
- Create visual separators between widgets  

---

## 🛠️ How to Use

<iframe className="w-full aspect-video" src="https://www.youtube.com/embed/vBUk6_Z9XLE?list=PLgErWFh-dyiGp9yUDnnx67wHEeNqzzMXZ" title="How to Use the Markdown Widget in OpenLIT – Visualize Trends Over Time" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

Example:

````markdown
### 🚀 User Growth Traces

This section highlights new user signups, retention, and churn over the last 30 days.

- Trace updated hourly  
- Based on `user_events` table in ClickHouse  
`````

---

## ✨ Supported Markdown Features

* Headings (`#`, `##`, `###`)
* Bold, italic, and strikethrough text
* Lists and checkboxes
* Code blocks and inline code
* Hyperlinks and external references
* Emojis 👍 🚀 ✅

---

## ✅ Best Practices

* Keep notes concise and relevant to nearby widgets
* Use emoji and headings to make sections scannable
* Update text as data sources or queries change

---

## 🔗 Related Guides

* [Area Chart Widget →](/latest/features/dashboards/widgets/area-chart-widget)
* [Bar Chart Widget →](/latest/features/dashboards/widgets/bar-chart-widget)
* [Line Chart Widget →](/latest/features/dashboards/widgets/line-chart-widget)
* [Pie Chart Widget →](/latest/features/dashboards/widgets/pie-chart-widget)
* [Stat Widget →](/latest/features/dashboards/widgets/stat-widget)
* [Table Widget →](/latest/features/dashboards/widgets/table-widget)
